home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / spiele / publicdomain / scott / docs / readme.txt < prev    next >
Text File  |  1996-07-29  |  7KB  |  181 lines
  1. This is my second serious production edition of the Scott Adams game
  2. player. It needs curses (or an equivalent - eg pccurses. A non-curses
  3. port should be easy too), and an ANSI C compiler.
  4.  
  5. This code has been tested on a SUN3(SunOS 4.1.1) and on a Pyramid 9820 in
  6. the att universe.
  7.  
  8. Installation
  9. ------------
  10.  
  11. Type 'make'. You will need a system with curses and an ANSI C compiler (eg
  12. gcc).
  13.  
  14. Operation
  15. ---------
  16.  
  17. ScottFree reads and executes TRS80 format Scott Adams datafiles. It is
  18. possible to run other formats either by writing a loader for that format or
  19. a convertor to TRS80 format. Remember the Scott Adams games are still
  20. copyright - you need to buy or obtain the games legally for use with this
  21. interpreter. Some Scott Adams material is available fairly freely . Dec 1980
  22. Byte contains a game driver and also a program to write a version of Pirate
  23. Adventure. A PC-SIG disk contains Adventureland in BASIC with a database in
  24. DATA statements. The file 'Definition' in this archive explains the TRS80
  25. format as I believe it exists. Much of this definition comes from P.D.Doherty
  26. who provided a lot of information.
  27.  
  28. ScottFree should run all the Scott Adams, Brian Howarth and some other
  29. Adventure International games. (Gremlins and Supergran have a compressed
  30. action table,  Robin Of Sherwood and Seas Of Blood have both a compressed
  31. action table and compressed text.  Seas Of Blood won't run straight off due
  32. to the bizarre Fighting Fantasy (tm) combat system built into it.)
  33.  
  34. Command Options
  35. ---------------
  36.  
  37. ScottFree [flags] <databasename> [save-file]
  38.  
  39. Specifying save-file causes a restore of the save to take place.
  40.  
  41. The flags are
  42.  
  43. -d      Debugging info on load
  44. -i      Generate 'I am' type messages (default)
  45. -y      Generate 'You are', 'You are carrying' type messages for games that
  46.         use these instead (eg Robin Of Sherwood)
  47. -s      Generate authentic Scott Adams driver light messages rather than
  48.         other driver style ones (Light goes out in %d turns..)
  49. -t      Generate TRS80 style display (terminal width is 64 characters; a
  50.         line <-----------------> is displayed after the top stuff; objects
  51.         have periods after them instead of hyphens
  52.  
  53.  
  54. Statement Of Copyright/License
  55. ------------------------------
  56.  
  57. This software is supplied subject to the GNU software copyleft (version 2)
  58. available from GNU or for FTP from prep.ai.mit.edu. All material in this
  59. program was developed by Swansea University Computer Society without
  60. disassembly of any other game drivers, only of game databases as permitted
  61. by EEC law (for purposes of compatibility). It is your responsibility not
  62. to transfer this software to any country where such reverse engineering is
  63. not permitted. This software license does not include any rights with
  64. regards to the Scott Adams games themselves. These games are copyright and
  65. you should obtain them from a legal source.
  66.  
  67. The following information sources were used to produce the game driver:
  68.  
  69. PC-SIG disk of Adventureland:
  70.         This gives the Adventureland database as well as about 80% of the
  71. full interpreter system. The core of the gamedriver was written using this
  72. as a reference to the game code.
  73.  
  74. Byte Dec 1980:
  75.         This contains a good article about Scott and his games, as well as
  76. a TRS80 driver and datafile writer for the 'Pirate Adventure' game. This
  77. filled in some more answers as well as bits of the TRS80 data format
  78.  
  79. P.D.Doherty:
  80.         Many thanks go to him for figuring out a load more actions, testing,
  81. hunting for games which used unknown actions and for writing a Scott Adams
  82. database to readable text convertor. This helped resolve several other
  83. actions.
  84.  
  85.  
  86. Changes 1.14
  87. ------------
  88.  
  89. o       Bit flag 16 support
  90. o       Lamp behaviour flag '-p' for prehistoric databases which don't use
  91.         bit 16
  92. o       Light out messages don't appear when the lamp is elsewhere.
  93. o       Automatic get/drop has synonym support.
  94.  
  95. Changes 1.13
  96. ------------
  97.  
  98. o       Darkness is now done like the actual Scott driver seems to do it,
  99.         using bit flag 15. Fixes problems in The Count
  100. o       Display problem with 4.4BSD curses fixed (added a wmove() call)
  101. o       Can't TAKE ALL in a dark room.
  102.  
  103. Changes 1.12a
  104. -------------
  105.  
  106. o       Merged in some fixes by Steve Rice <sarice@edaca.ingr.com>
  107.         (Variables for terminal size, wrong wraparound due to bug in Look(),
  108.         TRS80 style option)
  109. o       Updated PC version.
  110.  
  111. Changes 1.12
  112. ------------
  113.  
  114. o       Merged in some fixes by Antoine Sabot-Durand <sabot@fr.dgac.stna7>
  115.         (Redraw in dark rooms, darkness flag testing, Action 74 bug).
  116.         'Pirate Adventure' should now work.
  117. o       Added some comments
  118. o       Added a makefile
  119. o       Fixed several missing redraws.
  120.  
  121. Changes 1.11
  122. ------------
  123.  
  124. o       Major bug in file reading routines fixed. This should now read
  125.         _ALL_ the Scott Adams files without you having to add spaces.
  126. o       Knows about the use of // in item texts and correctly handles it.
  127. o       Uses unsigned char for the location of an item so that it correctly
  128.         behaves like the spectrum editions on wrapping. This makes a lot
  129.         more of the Brian Howarth material work.
  130. o       Rewrote the awful OutBuf() function to be a bit neater.
  131. o       Messed up the neat OutBuf() function by supporting old BSD curses
  132.         too. Linux people and 386BSD people should now be in luck, as
  133.         should any old BSD4.x users.
  134. o       TAKE ALL/DROP ALL. Emulates Brian Howarth driver including the
  135.         number of moves bug.
  136.         NOTE:: TAKE ALL/DROP ALL count as one move. In some games that
  137.         give limited moves for things this makes it easier or enables
  138.         you to do things you should not be able to. The Brian Howarth
  139.         games all have this feature and should be fine.
  140. o       Started work on an Xview version - don't expect it just yet.
  141. o       Fixed a major cockup in the execution rules for lines. Robin Of
  142.         Sherwood lets you out of the cell without killing you at last.
  143. o       Place item -> location failed with some compilers (most), now
  144.         made portable.
  145. o       WAIT action refreshes display first
  146. o       Redraws any pending display changes before the status table
  147. o       Option flags tidied up.
  148.  
  149. Changes 1.10
  150. ------------
  151.  
  152. o       Action 75 added (dunno how it was missed)
  153. o       Corrected second Byte year reference
  154.  
  155. Changes 1.9
  156. -----------
  157.  
  158. o       Inventory short cut
  159. o       Swap room flag/location now fixed. This should make Claymorgue work
  160.         correctly (ha!).
  161. o       Corrected Byte reference from 1990 to 1980.
  162.  
  163. Changes 1.8
  164. -----------
  165.  
  166. o       Move location action sets the redraw flag
  167. o       Driver ignored last line of table (now fixed)
  168. o       Save/Load implemented.
  169. o       N,E,S,W,U,D shortcuts added. I will add the item ones once I've
  170.         loaded a few more fake saves into the genuine Brian Howarth driver
  171.         to figure out how it works.
  172.  
  173. To Do
  174. -----
  175.  
  176. o       Tidy up TAKE ALL/DROP ALL. They match the Spectrum version -
  177.         which appears to be buggy. Also note that using GET ALL / DROP ALL
  178.         with older games _MAY_BREAK_THINGS_. Maybe this should be a flagged
  179.         option.
  180.  
  181.